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My Two Bits 

bn 

Tbm Weishaar 

"Congratulations on avoiding the Apple 
Computer Co. = Apple 11 computer' trap!' 
writes Brooke Boering (author of the freeware 
programs Fire Organ and One-Fey DOS) in 
response to last month's My Two Bits. Open- 
Apple is primarily about the Apple II compu- 
ter. But it's important to keep a watchful eye 
on our friends at Apple, Inc, as well. As noted 
here last month, there is far more respect for 
the Apple 1 1 outside the company than inside 
it There is tremendous technological pres- 
sure inside Apple to "improve" the Apple II 
beyond recognition, even though those of us 
on the buying side are only beginning to 


understand what we can do with the unimproved model. 


This pressure doesn't come entirely from within Apple. The February Popular 


Computing includes a review of the Apple 11c that includes statements like these: 


"I found the lie to be just a second facelift for the Apple II Plus. Cosmetic surgery 
is fine in some cases, but nothing short of major internal surgery will modernize 
the Apple II line." 

"Prom a design perspective, compatibility is the He's Achilles' heel. To maintain 
that compatibility, Apple's engineers couldn't make the He very different from its 
predecessors!' 

"The He isn't a bad computer. It's just a computer based on aged technology!' 


The technonerd that wrote that review like his many confederates inside 
Apple, has precious little understanding of why we users have purchased more 
than two million of these machines. We want them precisely because the Apple 11 
has evolved. 

Ask hackers who were weaned on Radio Shack Model Ones, Commodore Pets, or 
Texas Instruments 99/4s what they eat for dinner nowadays. All the time and 
energy they spent learning how to use those lizards has lost its worth. Meanwhile, 
those of us lucky (or wise, as the case may be) enough to start with an Apple have 
something of appreciating value inside our heads. 

It is Open-App/e's editorial policy to protect that investment We'll happily make 
-* mock of Fopu/arComputingorany other publication that attempts to liquidate our 
* investment And we'll be watching developments at Apple, Inc. for internal attempts 
to bankrupt us, too. 

It's important to realize that those of us who already own Apple 11s represent a 
/ significant proportion of Apple Computer, Inc's, future revenue. It's a fiindamental 
rule of business that people who have bought a company's products in the past are 
more likely than anybody else to buy again. 

According to press reports, Apple sold about 750,000 lies and lies in 1984 (up 
from 580,000 in 1983). About a third of those went to homes, offices, or schools 
that already had an Apple in the family. That proportion will increase, not decrease, 
from here on out 

Looking at the data another way, 37 per cent of the people who already own a 
computer expect to buy another within a year, while only 13 per cent of non-owners 
expect to buy, according to a study done last summer by Dataquest and Software 
Access International. 


Apple's president, John Sculley, is a marketing man. Marketing men live by the 
commandment that a company shalt produce goods that customers want to buy 
rather than goods that engineers want to produce. 

Unfortunately, it isn't at all certain that Scully and Apple are taking the desires of 
current Apple II owners seriously— even though we represent a ton of future 
business potential. One gets the impression that their market research is totally 
based on people who have either never seen a computer before or who have used 
only competitive brands. 

The latest example of this disregard for current owners is word from reliable 
sources that future models in the "Apple II family" won't support DOS 3.3. (If it 
won't support DOS 3.3 it's not an Apple II, is it?) 

The reason the new machines can't use DOS 3.3, Apple's engineers say, is 
that Apple is converting all its computers to the 3 1/2-inch plastic-encased disks 
used on the Macintosh. These disks hold 409,600 bytes of data. DOS 3.3, we are 
constantly misinformed (most recently in the January 1985 inCider, page 82), can 
handle disks no larger than 143,360 bytes. 

As the owners of 40-track drives know, this upper limit is all myth. DOS 3.3 will 
work, without modification, on disk drives having as many as 50 tracks and 32 
sectors (the equivalent of exactly the Macintosh's 409,600 bytes). Apple's engi- 
neers, however, don'tseem to know this. (Quick, name the only company that sells 
a hard disk for the Apple 11 that doesn't support DOS 3.3.) 

I can't believe a marketing man like Sculley would let a decision like this be made 
if he knew both the true potential of DOS 3.3 and how his best customers feel about 
it Since his marketing and engineering minions don't seem to be telling him, I 
guess you and I will have to. Fire up your word processor and let Sculley know what 
you think. In case you don't have it handy, his address is: 

John Sculley, President 
Apple Computer, Inc. 

20525 flariani five 
Cupertino, Calif. 95014 

Lest I be misunderstood, let me make it clear I have nothing against 3 1/2 inch 
disks. I think they're wonderful. I have nothing against ProDOS. I think it's wonder- 
ful too. But the common investment of time, knowledge, and productive software 
Apple users have in DOS 3.3 is simply too valuable to walk away from. If Apple's 
engineers can't figure out how to get DOS 3.3 to work with 400K disks, there are a 
dozen or more companies with names like Corvus, Rana, MicroSci, and Diversified 
Software Research who could show them how. It's time for Apple to spend a little 
more of its research and development money on its bread and butter producL 

Enough of my blustering. The theme of this month's Open-Apple isn't monitor- 
ing Apple— our main task, actually, is to investigate the Apple Monitor. First, 
however, 1 want to thank all of you who have already signed on as Open-Apple 
subscribers. The response rate you've given our subscription campaign has been 
fantastic— and we didn't even have a sweepstakes. 

A Song Called the System Monitor 

One of the greatest death scenes in all movie history, according to a film critic 
friend of ours, occurs in 2001: A Space Odyssey. HAL, an intelligent computer on 
board a spaceship bound for Jupiter, decides the biggest risk to his mission's 
success is human error and becomes very hostile toward the astronauts accom- 
panying him. 

Dave, a human spaceman, eventually works his way into HAL's memory bank and 
starts removing ROMs and RAMs (which look like small glass slabs). As each slab is 
removed, HAL loses intelligence. HAL pleads with Dave to stop. As Dave yanks out 
HAL'S last bit of intelligence, HAL is singing Daisy, which was the first thing he ever 
learned. 
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Fortunately, Apples are meek and mild-mannered machines. But if the day ever 
comes that you find it necessary to climb inside and start removing intelligence, 
the last thing your Apple will sing is a song called the System Monitor. This is the 
first thing Apples ever learned. It includes software Steve Wozniak wrote in 1976 to 
impress his friends the Homebrew Computer Club. 

Cornerstone treasures. The Monitor software is very elementary. But it's the 
cornerstone of the Apple's operating system. 

When people talk about the Monitor, they usually mean one of two things (or 
three things, if you count display screens). In one sense, the Monitor consists of all 
the machine language subroutines found between byte 63488 (in hex that's 
$r800) and 65535 ($FFFF). These routines do things such as retrieve the mes- 
sages you type on your keyboard, print text on your screen, and beep your speaker. 

In addition, these routines include a program that allows you to interact with 
your Apple. Using this program, you can determine or change the contents of any 
memory byte, move data around in memory, verily that two ranges of bytes are the 
same, and do hexadecimal arithmetic and other stuff. This program, although it is 
really just a subset of the entire Apple system monitor, is also usually called the 
Monitor. 

The Monitor program, like the rest of the system monitor, is very elementary. 
Most of the commands consist of a single character. Error messages consist of a 
single beep, nonetheless, it provides a way for you to "get inside" your Apple and 
deal with it on a byte level— at any time. Very few other computers have a built-in 
program that opens the system up to you as much as this one does. 

In and out. The Monitor program starts at byte 65385 ($FF69). You execute the 
program by entering call 65385, or more typically, call -151 (a negative 151 and a 
positive 65385 appear to Basic as the same number when you're using the call 
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command). When you enter one of these commands, the Applesoft bracket prompt 
will change to an asterisk, like this: 

jCPLL -151 


The asterisk prompt is your signal that you are "in the Monitor". Mow that we're 
here, let's figure out if there's anything we can do that's useful. 

First of all, try entering a familiar Basic command. How about 

»PRINT "HI" 

(beep) 

Ho luck. That beep, however, is the Monitor's signal that you made a syntax error, 
notice that no error message is printed on the screen. How about a DOS com- 
mand? Try this: 

»CPTfiLQG 

DISK VOLJUE 254 

P 002 hELLO 
. . .ana so on 

DOS commands workjust fine from within the Monitor. I've Just shown a DOS 3.3 
catalog, but ProDOS works too. With DOS 3.3 you'll see a string of numbers 
following the command's display. ProDOS eats these for breakfast If the numbers 
intrigue you, look at the If Then Maybe column in the June 1984 Softalk. On page 
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makes a good deal more sense when you have large amounts of space like this to 
work with. 

Besides their large capacity, hard disks are also famous for their speed. This is 
because the disk is always spinning— there's no coming-up-to-speed delay— and 
because it spins much faster than a floppy can. The following chart compares how 
long it takes to sequentially load ten high-resolution graphics from a floppy disk, 
the Sider, and a RAM (memory-based) disk. It's interesting to note that the operat- 
ing system you use makes a lot of difference. Ifyour primary interest is speed rather 
than capacity, a speed enhanced DOS— such as ProntoDOS, DiversiDOS or 
ProDOS— helps more than a hard disk or even a RAM disk. 


The Sider. By First Class Peripherals. The Sider is a 10 megabyte hard disk drive for 
the Apple II-Plus and lie that sells, by mail order only, for $695. At this eye-opening 
price I thought we'd better try one. So far I'm impressed. 

About four weeks after 1 placed my order, UPS delivered a massive, mostly empty, 
box. Inside were the drive itself, a peripheral card for slot 7, and some cables and 
instructions. The thing takes about two hours to install and initialize. 

After the Sider is installed, your system uses it for booting when you turn on your 
computer or press open-apple-reseL If you haven't turned the Sider on, your 
computer will "lock-up"; but you can press control-reset to enter Basic and PR^6 to 
boot from your floppy drive if you want to go that route. 

When the Sider starts up, a menu appears that gives you your choice of booting 
CP/M, Pascal, ProDOS, or DOS 3.3. You can also boot a floppy disk in slot 6 (it 
usually won't be able to use the hard drive, however), run system utilities, or park 
heads (quit) from this menu. 

One small problem with the way the Sider supports all four operating systems is 
that you have to set aside at least a few sectors on the disk for each of them. The 
actual share of space each gets is up to you. The system utilities and the main 
menu program run under DOS 3.3. It's the only operating system that actually 
comes with the drive— you must buy the master disks for the others from the 
appropriate source, as usual. 

Under DOS 3.3, the Sider appears to be a bunch of floppy disks, each with a 
different volume number, in slot 7, drive I If you initialize the Sider with the 
maximum amount of DOS 3.3 disk space, you'll get 61 standard 140K volumes, 
numbered 1 through 61 You access these with the standard DOS 3.3 ^parameter, 
for example, CATALOG, V33. You can switch back and forth between these 61 
"disks", or volumes, simply by specifying different numbers. If you don't specify a 
number, you get whatever volume you used last 

Under DOS 3.3, the Sider also allows you to have large, 400R volumes. As 
mentioned in My Two Bits, DOS 3.3 can handle disks of this size without modifica- 
tion. You can have up to 22 of these larger volumes at one time. 

As implemented on the Sider, ProDOS must always have two equal-sized 
volumes. They're called /hardl and /harc/2. If you maximize the ProDOS space at 
initialization, each volume will have 9,076 blocks of space — a little over 4.5 meg- 
abytes each. The ProDOS system of prefixes, subdirectories, and pathnames 
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An unusual feature of the Sider is that one periperhal card can handle a two-drive 
system. Most hard disks for the Apple don't have that capability. Those of you with 
uninterruptable power supplies (review upcoming in a future issue) will be happy to 
learn that the Sider draws only 40 watts of power. 

If the Sider has a weakness, it's the documentation. Don't expect the manual to 
be as slick as the company's advertising. The manual does an adequate Job of 
explaining how to install and initialize the drive and how to troubleshoot any 
problems. However, it's quite thin on actual operation. The "park heads" selection 
on the main menu, for example, isn't mentioned in the manual. I assume it's bad 
news if the lights go out with the heads engaged, but who knows— the manual 
doesn't say anything about how to turn the unit off. 

The Sider comes with a one-year warrant)'. To receive service you must first follow 
a diagnostic prodecure outlined in the manual. If the unit is defective you then call 
to get a repair authorization and return the drive in its original packing to First 
Class Peripherals. They fix it free while it's in warranty; they charge $150 after that 
Are these folks for real? Apple charges $1495 for its 5 megabyte Profile hard 
drive — half the capacity at twice the price. This is a new company and buyers take 
the risk they won't be around long. However, they appear to be doing things right 
Their strategy is to sell by mail at below retail prices. Their market is Apple 1 1 users 
willing to forgo a dealer's handholding in exchange for those prices. (I suspect 
there's hundreds of thousands of people like that) 

The drive itself is manufactured by a company called Xebec. Members of the 
Apple users group in Miami bought a bunch of these drives a few months ago and 
our friends down there say they've been happy with them. I'm certainly happy with 
mine. 

The Sider, by First Class Peripherals (RO. Box 6187, Lehigh Valley. Penn. 18001 ; 800-538- 
1307). One-year warranty. $695 
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141 of that issue, Roger Wagner throughly explores where these meaningless 
numbers come from and why. If these numbers don't intrigue you, just ignore them. 

Mow open the door on your disk drive and try the catalog command again. This is 
a good way to force a disk i/o error. Why do that? Tty it and see: 

»CflTflLQG 

I/O ERROR (beep) 

] 

This time you do get an error message. This is because DOS is sending the 
message to you. But the important thing to notice is the prompt you get after the 
error. A DOS error from within the Monitor always lifts you back up into Applesoft. 
Enter call -151 again, and try out what happens when you press control-reset Once 
again the Applesoft prompt will reappear. 

So we've established that call -151 gets you into the Monitor and that control- 
reset gets you back out Basic commands don't work in the Monitor; DOS com- 
mands do; however, they send you to Applesoft after an error. 

Hexamining memory. How let's try Just pressing return a few times. Voila! You 
should get a display that looks something like this, but probably with different 
numbers: 

* (press return) 

8800- P2 00 fl0 02 88 81 3Z 

* (press return) 

8808- 3E 00 8C 4fi 3E 00 BC 99 

* (press return) 

8810- 00 88 E8 E0 56 90 ED P2 

riot your normal, school-kid, decimal numbers, mind you; but hexadecimal 
numbers. 

In our friendly, everyday decimal system, each digit has ten possible values, 0 
through 9. The digit on the far right represents units or ones; the next one to the 
left, tens; the next hundreds (10 ’ 10); the next thousands (10 * 10 * 10) and so on. 

The hexadecimal system works exactly the same way, except each digit has 
sixteen possible val ues, 0 through E (Start at 0, go up to 9, use A for 10, B for 11; E for 
15.) Just as in the decimal system, the digit on the far right represents units or ones; 
the next one to the left, sixteens; the next 256s (16 * 16); the next 4096s (16 ’ 16 * 
16); and so on. 

A two-digit hexadecimal number can range in value from $00 (0) to $FF (255). A 
dollar sign in front of a number indicates it is a hexadecimal number. A four-digit 
hexadecimal number can range in value from $0000 (0) to $FFrF (65555). 

Lx)ok again at the display you get by simply pressing on the return key. The 
numbers on the left edge of the screen are four-digit hexadecimal numbers. They 
represent an address in your Apple's memory. The bytes that make up computer 
memory can be considered small electronic cells that can hold any value between 
0 and 255. Each of these cells has an address— kind of like a Post Office Box 
number. From the Monitor, you can examine the contents of these cells by simply 
pressing return. 

In the above example, the contents of cell $B800 (47104) is $A2 (162); $B801 
holds $00; $B802 holds $A0; and so on. Each line of the display shows you the 
values in eight consecutive bytes. The second line begins with byte $B808, the third 
with byte $B810. 

Fine, but what if you want to see the value in byte $03D0, not byte $B800? Just say 
so: 

*0300 
0300- 4C 

You can determine the value currently in any of your Apple's memory bytes by 
simply giving the address of the byte you are interested in (in hexadecimal) and 
pressing return. If you specify an address with a number that has less than four 
digits, leading zeros will be added automatically. If you specify more than four 
digits, all but the final four will be ignored. Thus: 

*2 

0002- 04 
*20 

0020 - 00 

*20000 
0000- 4C 

If you are interested in the values in a range of memory bytes, you have two 


Open-Apple 11 

choices. The first is to give the address of the first byte you're interested in and then 
press return a bunch of times. This gives you a display like this one: 

*300 

0300- 4C 

* (press return) 

BF 90 4C 84 90 4C FO 

* (press return) 

0308- Pfl 4C 85 87 RO 0F 90 RC 

* (press return) 

03E0- 0E 90 60 RD C2 RR RC Cl 

Alternatively, to see a range of bytes you can give the beginning address of the 
range followed by a period and the ending address, like this: 

*300. 3E3 

0300- 4C BF 90 4C 84 90 4C FO 
0308- RR 4C 85 87 RO 0F 90 RC 
03E0- 0E 90 60 RO 

If you give a long range, such as 2000.5000, the values will quickly scroll by on 
your screen. You can stop the scrolling by pressing control-S; restart it by pressing 
control-S a second time (any other alphanumeric key will also restart scrolling). 

You can send these memory dumps to your printer, if you like. Use the DOS 
command pr^l (assuming your printer is connected to slot 1) to pass output to 
your printer. Use pr^O to stop it again. (The Monitor also includes its own versions 
of the pr^ and in^ commands, but they interfere with DOS. Always use the DOS 
versions.) 

Disassembling your Apple. If you have a silcon-based brain, you may find 
these rows of hexadecimal numbers very interesting and useful. If, on the other 
hand, you have a carbon-based brain like most humans, you probably find them 
difficult to work with. For you the Monitor has a command called List Beginners 
won't find its display any more intelligible than the last, but experienced users find 
it quite useful. To use List, enter an address, put an L immediately after it (don't 
include a space), and press return: 

*3D0L 


03D0- 

4C 

BF 

9D 

JflP 

$9DBF 

03D3- 

4C 

84 

9D 

JMP 

$9084 

03D6- 

4C 

FD 

RR 

JflP 

$RRFD 

03D9- 

4C 

85 

87 

JflP 

$8785 

03DC- 

RD 

0F 

90 

LDR 

$9D0F 

03DF- 

RC 

0E 

90 

LDY 

$9D0E 

03E2- 

60 



RTS 


03E3- 

RO 

C2 

RR 

LDR 

$RRC2 

03EG- 

RC 

Cl 

RR 

LDY 

$RRC1 

03E9- 

60 



RT5 


03Efl- 

4C 

51 

R8 

JflP 

$R851 

03ED- 

ER 



NOP 


03EE- 

ER 



NOP 


03EF- 

4C 

59 

FR 

JflP 

$FR59 

03F2- 

BF 



999 


03F3- 

9D 

38 

4C 

SIR 

$4C3B,X 

03FG- 

58 



CL I 


03F7- 

FF 



999 


03F8- 

4C 

65 

FF 

JflP 

$FF6S 

03FB- 

4C 

65 

FF 

JflP 

$FF65 


This range of memory (which you'll only get if you booted with a DOS 5.5 disk) 
begins at the same byte as our earlier row-by-row display. Again, the numbers on 
the left indicate the addresses of the bytes revealed on the righL The numbers in 
the three columns in the middle of the display are the actual values in these 
memory cells. Ifyou compare them to the row-by-rowdisplay you'll find they are the 
same. 

The difference is that the List command assumes these numbers are a machine 
language program. List organizes the numbers into a meaningful display. On the 
right side of the display is an assembly language translation of the machine 
language instructions. 

For example, the machine language code for jump (equivalent to Basic's goto) is 
$4C. The address of the machine language program that is to bejumped to always 
follows the Jump command byte. In machine language, addresses are usually 
written backwards. (Flo, 1 don't know why.) Thus the 4C BFDD in the first line of oui 
display translates into JMP$9DBr. 
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The List command isn't always able to give a true translation of a range of 
machine language instructions. For example, look at the question marks near the 
bottom of the listing. The stuff stored in bytes $3F2 through $3F4 is data, not a 
command. But the List command has no way to know that It insists on translating 
the data as if it were a meaningful instruction and gets nowhere. 

If you have a lie, incidentally, the List command will correctly list the additional 
codes of the 65C02 instruction set, something the List command in other versions 
ofthellcan'tdo. 

How you know how to list the contents of your computer's memory as raw 
hexadecimal values and as a machine language program. There is one other useful 
format for examining memory— as ASCII values. Many bytes hold a number that 
actually represents a letter or other character. The Monitor can't show you those 
letters and numbers directly, but we'll show you how to get a peek at them In a 
minute. 

Warning: when examining your Apple's memory with any of these techniques, 
avoid the area from $C000 to $C0FF. This range of memory addresses doesn't 
contain true memory bytes. Instead, It's full of soft switches that control your Apple 
and the peripherals connected to it Throwing these switches accidentally can 
mess things up. Mon-believers may enter C055 (return) and rejoin us after using 
control-reset to recover. 

Making changes. We've looked at how you can enter the Monitor with the call 
-151 command. There are also other ways to enter the Monitor. You may be familiar 
with "crashing" into the Monitor, which happens when a machine language pro- 
gram executes a break Instruction. The reset key can also be used get into the 
Monitor if you make some adjustments to a few special memory cells. 

Scan back and look at that "data" we saw earlier at bytes $3F2 through $3F4 
when we used the List command. What that data actually represents is an address 
the Monitor will jump to when you press the reset key, and a check byte that makes 
sure the reset address is current If you look at bytes $3F2 and $3F3 in the above 
display, you'll find they say BF 9D. Turn them around, since they are in the back- 
wards machine language notation, and you have $9DBF. This is the same address 
the first line of our display jumped to. 

Under DOS 3.3, $9DBF is the beginning of the DOS "warmstart" routine. (Under 
ProDOS, those bytes point to $BE00, which is Basiesystem's warmstart address.) 
Thus, pressing reset normally warmstarts DOS, which in turn warmstarts Basic, 
which in turns explains why we go from the Monitor to Applesoft when we press the 
reset key. 

If instead of Applesoft you'd like control-reset to put you in the Monitor, all you 
have to do is change the address at $3F2 so it points to the beginning of the 
Monitor program. As we learned earlier, the Monitor begins at $FF69. To make it all 
work, you also have to puta $5A in byte $3F4. Ifyou wantto know why, read the June 
1983 DOStalk, which examined all this in detail. You might also like to look at 
Trapping Reset on page 16 this letter. 

So now we know we want to put 69 FF 5A in bytes $3F2 through $3F4. But how? 

In addition to allowing you to examine memory, the Monitor makes It quite easy 
to change the values in memory cells. As before, you give the address you want to 
start at, follow it immediately with a colon, and then enter the values you want in the 
specified bytes. You must separate the values with spaces, like this: 

*3F2:6g FF Sfl 


You can change up to 85 consecutive values in one command line— just make 
sure you put a space between all the values. You can also enter a few values on one 
line and continue where you left off in the next line by simply entering a colon with 
no leading address. 

After changing some bytes, you can confirm the presence of your new values by 
pressing return as many times as necessary. The returns will produce a memory 
display that begins at the last complete address you entered. Watch: 

*2000:11 22 33 
»:44 55 66 
*:77 80 99 
BB CC 

* (press return) 

2000- 11 22 33 44 55 66 77 88 

* (press return) 

2008- 99 fiP 80 CC 00 00 00 00 

« 

Let's assume you've made the 3r2:69 FT 5A change to fix your Apple so that 
control-reset will always take you to the Monitor (until the next time you re-boot, 
anyhow). Mow how do you get back to Basic? 

The first line of the disassembly display we looked at earlier also contained a 
jump to the DOS warmstart address. The Monitor has a command, called Go, that 
allows you to execute the instructionsatany memory address. To get back to Basic 
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now that we've changed how control-reset works, we can do this: 

»3D0G 

1 

In this command, 3D0 (note that's a zero, not a big o) is the address we want to 
jump to, the Q tells the Monitor to jump. This address, $3D0, is known as the DOS 
warmstart vector, and is a worthwhile address to remember ifyou use the Monitor 
much. 

Let me see letters. Control-Y is known as the Monitor's user command. 
Assembly language programmers can write a special routine, place its address at 
$3F9-$3FA, and execute it directly from the Monitor by entering control-Y. Here's a 
special routine that you can use to change the Monitor's memory dumps from 
hexadecimal numbers to their equivalent ASCII characters: 


*3F9: 

:00 

03 






(put 

address df routine at 53FB) 

*300: 

:fi5 

3C 

29 

07 

D0 

03 

20 92 

(put 

routine at 5300) 

»:FD 

81 

3C 

40 

29 

7F 

C9 

20 



*:B0 

08 

CD 

CD 

09 

C0 

40 

P9 

DE 



*:D0 

02 

fl9 

P0 

20 

ED 

FD 

68 



*:20 

ED 

FD 

20 

Bfi 

FC 

90 

Da 




*:60 

After typing all this in, check it carefully. If you heard any beeps as you were 
entering the line, you made a mistake— probably you substituted an 0 for zero. 

How you can examine memory in ASCII by entering the examine memory com- 
mands just as before but also pressing control-Y before pressing return. Charac- 
ters preceeded by an in the display are control characters: 

*fl880.PB00(control -Y, return) 

fl3B0-']'E 7 I N I T 
fl3B0- LOflOSflVE 

. . .and so on. 

This month you've learned how to examine the contents ofyour Apple's memory 
as raw hexadecimal values, as an assembly language program listing, and as ASCI I 
characters. You've also learned how to enter new hexadecimal values into memory, 
next month we ll examine some of the fancier things the Monitor can do, such as 
move and compare values. For now, however, let's look at some Monitor tricks 
involving Applesoft, DOS, and Logo. 

Picking Up 
Applesoft 

The Basic connection. Getting the Monitor to dump memory in ASCII as we've 
just done is a nice feature, but typing in all those hexadecimal numbers is a pain in 
the chips. If we were dealing with Basic, we could write a program and save it, but 
there's no way to do that from the Monitor. We could save those two ranges of 
memory we've typed in as binary files and write a Basic program that would reload 
them, but then you wouldn't learn anything new. 

Several years ago a fellow named S.H. Lam wrote a letter to Call -A.RRLE. in 
which he showed how to execute Monitor commands from Basic. This technique 
has since been used all over the place. I even used it in DOStalk in March (DOS 3.3 
disk free space patch) and May (DOS 3.3 type command). 

The technique provides for entering, editing, and saving machine language 
programs and requires relatively few characters to be typed, which cuts time, effort, 
and mistakes. 

Unfortunately, people often have trouble getting all the Is dotted and Ts crossed 
when using this technique — especially when typos sneak into program listings, as 
happened in the May DOStalk. 

The technique works like this. You write an Applesoft program that simply 
defines what you would normally type into the Monitor as a string. After defining the 
string, your program jumps to a subroutine that gets Applesoft to type the string 
into the Monitor for you. Here's the magic subroutine: 
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500 C$=C$ + " N D9CGG'' : REM space required before and after N 
510 FOR 1=1 TO LEN {C$] 

512 : POKE 511+1, fl5C(MIDS(CJ , I ,1) )+12B 
514 NEXT 

520 POKE 72,0 : CPLL -144 
530 RETURN 

The first line of this routine tacks H D9C6G onto the end ofyour command string, 
note that there must be a space before and after the n. More than 95 per cent of all 
reported problems with this technique are caused by a missing space between the 
opening quote and the n. 

If your command string (C$) is 500:0, then after line 500 is executed it will be 
500:0 H D9C6G. Lines 510-514 poke this command string into your Apple's key- 
board input buffer. Line 520 calls a machine language subroutine inside the 
Monitor that executes whatever's in that buffer. 

In this case the Monitor would put a zero at byte $300, set display to normal, and 
jump to $D9C6. $D9C6 is a charmed spot inside Applesoft that continues execu- 
tion of our Applesoft program. In this case we continue at line 530's return from the 
Lam subroutine. 

One problem with the Lam technique is that the shortcut we used earlier of 
entering a colon without an address doesn't work. Here's how you would set up an 
ASCII memory dump loader using the Lam technique: 

100 C$="3F9:00 03" : GOSUB 500 
110 CI="300:fl5 3C 29 07 D0 03 20 92" : GQ5UB 500 

120 CS="30B:FD B1 3C 48 29 7F C9 20" : GOSUB 500 

130 CS="310:B0 0B 6B 09 C0 4B P9 DE~ : GOSUB 500 

140 CI="31B:D0 02 fl9 fi0 20 ED FD GB" : GOSUB 500 

150 C$="320:20 ED FD 20 BFl FC 90 DB" : GOSUB 500 

1G0 CS="328:G0" : GOSUB 500 
170 END 


500 CS=CS + " N 09CGG" : REM space required before and after N 
510 FOR 1=1 TO LEN (CS) 

512 : POKE 511+1, fl5C(MID$(C$, I ,1 ) )+12a 
514 NEXT 

520 POKE 72,0 : CfiLL -144 
530 RETURN 

To save even more typing time, the lines from 100 to 170 could be combined. But 
there's an even better way, and it's a DOS trick. 

Digging 
into DOS 


Writing Monitor programs. Earlier in this letter, 1 pointed out that DOS com- 
mands work from within the Monitor. This flexibility leads to an interesting trick. 

When considering DOS commands that you can use inside the Monitor, you will 
think right away to try catalog, but how about fp or bload myfile or -/users.disk/ 
convert? Here's the real beauty, though, exec ascii. dump. 

The exec command works just fine from inside the Monitor. What you put in the 
text file you'll exec is bare Monitor commands. Instead of typing in a whole Basic 
program, all you really have to do Is sit down at your word processor and enter: 

CALL -151 (optional, not needed if you exec from 

within the Monitor. ] 

3F9:00 03 

300:fl5 3C 29 07 00 03 20 92 

308:FD B1 3C 4B 29 7F C9 20 (as with the Lam technique, you must use 

310:80 08 GB 09 C0 48 P9 DE a loading address on each line.) 

31B:D0 02 fi9 fi0 20 ED FD GB 
•320:20 ED FD 20 BR FC 90 DB 
32B:G0 

Use a word processor to create an exec file filled with Monitor commands. This 
gives you the ability to edit your mistakes and to save your work. How we can write 
"Monitor programs". It works with both DOS 3.3 and ProDOS. 

If you get into this, you might want to use it to edit our control-Y program a little. 

; Change byte $303 to $0r and you'll get a display 16 columns wide. A $ir at that spot 
will give you a 32-column display— a nice use for your 80-column screen (which, of 
course, you can turn on from within the Monitor with a pr^5). 
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It's not the kind of thing they teach your children in school, but the Apple 
Monitor Is readily available from Logo just as it is from Basic. With most Logos, the 
command call -151 or its equivalent is probably the most convenient way to get into 
the Monitor. 

With Apple's 128K version, however, getting Into the Monitor requires a few tricks. 
You can't simply call the Monitor's starting address, because Logo turns on and 
uses all 128K of RAM memory. The Monitor ROM is turned off and is invisible when 
you're inside Logo. 

On Apple's 128R computers, pressing Reset automatically turns on the ROM, 
making it momentarily accessible, normally Logo traps a press of the Reset key, as 
we did earlier in this letter. It quickly turns the ROM back off, the RAM back on, and 
informs you that you've pressed the Reset key and should reboot The reboot 
message seems a little heavy handed, however, since your program and data are 
still intact and ready to run. 

To get into the Monitor, we can change the contents of the soft-entry vector. Then 
Reset will provide our passageway in. This is easy enough. The problem then 
becomes one of getting back out again. Apple's 128R Logo doesn't support the 
standard $3D0Q warmstart address. 

To solve this, let's move the contents of Logo's soft-entry vector into the control-Y 
vector. Then when we press control-Y from inside the Monitor, we'll go back to Logo 
via its Reset trap, and all necessary bank switching will be handled for us. 

Logo commands will look like gibberish to those ofyou who have never encoun- 
tered them before, so we'll explain them a little. In Logo you write programs by 
creating a series of subroutines, called procedures. Each procedure is given a 
name and you execute the procedure by simply saying its name. You might, for 
example, write a routine that draws a house on the high-res screen and call it 
house. Every time you enter the word another house will appear on the screen. 

Let's write a short program, called mon, that will poke the changes we need Into 
the soft-entry and control-Y vectors. Apple's 128R Logo does have all the primitives 
(built-in procedures) we need for this. If you are using a different version of Logo, 
yourverslon may have different names for these primitives. .DEPOSIT adr vails like 
a Basic poke. .EXAMIflE adrls like a Basic peek. 

first, let's write the procedure that will do the actual poking. 

TO DO. MON. POKES 
.DEPOSIT 1017 .EXRMINE 1010 
.DEPOSIT 101B .EXRMINE 1011 
.DEPOSIT 1010 105 
.DEPOSIT 1011 255 
.DEPOSIT 1012 90 

END 

The to tells Logo we are writing a procedure. This causes what we type to be 
stored, rather than executed immediately; the same effect line numbers have in 
Basic. The effect lasts until we type end, which tells Logo we are done with that 
procedure. 

After the to you put the name ofyour procedure. On the next and following lines 
come what you want to do. The first two lines of our procedure move the Reset-trap 
address that Logo keeps in the soft-entry vector into the control-Y vector. The final 
three lines poke the address of the Monitor program Into the soft-entry vector and 
correct the power-up byte. 

One problem with do.mon.pokes Is that If you run it twice, by accident or 
otherwise, the control-Y vector ends up with the Monitor's address in it and you 
can't get back to Logo. Let's write another procedure that will call do.mon.pokes, 
but only if it hasn't been run already. We can tell by looking at byte 1018, which 
always equals 255 before running do.mon.pokes and some other value afterward. 

TO MON 

IF 255 = .examine 1018 [DO.MON.POKES] 

END 

That's all there is to it To execute, type mon, then press Reset 
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Detecting NOT SELECTED 

Is there an easy way to detect that a printer is off 
before the HOT SELECTED message appears? 

Harold D. Portnoy 
Bloomfield Hills, Mich. 


(For those of you who don't have the Grappler-^ 
interface card, the Grappler places a beep and the 
words "TfOT SELECTED" in the middle of the screen 
when you try to print something and the printer is 
turned off or deselected.) 

The standard answer to this question is no. How- 
ever, if you are writing software for your own system 
and thus know in advance what printer and interface 
card your program will use, it can be done quite 
easily. 

Enter the Monitor with a call -151 and take a look at 
the softswitches associated with your printer. There 
are sixteen of them; they begin at $C08Ch-s0, where 
s=yoursiot number. If your printer interface card is in 
slot I for example, look at the switches $C090.C09F 
Start with your printer turned off. 

(printer off) 

‘C090.C0SF 


C090- 51 51 51 51 51 51 51 51 

C09B- 51 51 51 51 51 51 51 51 

(turn your printer on; leave unselected) 
*C090.C09r 

C090- 50 50 50 50 50 50 50 50 

0090- 50 50 50 50 50 50 50 50 

(printer on; selected) 

*0090. C09F 


0090- 53 53 53 53 53 53 53 53 
0098- 53 53 53 53 53 53 53 53 

The values shown here are what you'll see if you 
have a Orapp/er+. Other cards will display other 
values. Ail you have to do now is peek at one of these 
locations and see if the expected value is present. For 
example: 

10 SL0T=1 
20 N$=''N0T" 

30 IF PEEI<(49280+5LOT»1G) = 83 THEN N$="":REf1 83=153 
40 PRINT NS;" 5ELEOTEO" ; GOTO 20 

RUH this program while selecting and deselecting 
your printer. If you have a lie, you'll find that it can't 
tell the difference between a printer that is selected 
and one that's turned off (though it can tell selected 
from deselected if the printer is turned on). I suspect 
this will be true of all serial printer interfaces. 

ProDOS and compilers 

Can 1 use a DOS 3.5 Applesoft compiler (Einstein, 
TASC, Expediter), transfer the object code to ProDOS 


using Convert, then patch the I/O hooks to get Pro- 
DOS to recognize DOS commands? 

Michael Couvillon 
EL Walton Beach, Fla. 

/ haven't tested it, but theory tells me it will never 
work. FroDOS uses a different scheme for recogniz- 
ing DOS commands than DOS 5.5. Anybody out there 
know of an Applesoft compiler that can produce 
ProDOS-compatible object code? 

FIND:/user group/ 

Do you know of any Apple 1 1 user groups in my area 
(northeast comer of Oklahoma)? 

Claude E. Williams 
Jay, Okla. 

You're surrounded by them— but they're all about 
60 miles away. I don't have anything on these groups 
except their addresses, but you could write for more 
information: 

Tulsa Computer Society's fipple Users 
P.O. Box 1133 
Tulsa, OK 74101 

Joplin Apple Users Group 
1903 E. 3Gth 
Joplin, no 64801 


RazorbacU H.fi.U.G. 

3000 Rogers five. 

Fort Smith, AR 72901 

If you have a modem, the closest groups to you are 
probably the Micronet Apple User Group on Compu- 
Serve and the Source Apple User Group. 

Incidentally we're trying to develop a data base on 
Apple user groups here at Open-Apple. We also 
exchange subscriptions with groups that have news- 
ietters. 

Msg from a parallel universe 
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^ourER CEREAL^ 

1 tried the programs dealing with the onerrroutines 
in the January issue (page 2) and put the "empty” file 
on the ProDOS /ram volume. This speeds things up 
greatly and makes life easy on the old disk drives. It 
also executed the onerr routine 8,400 times without 
fail while 1 watched the late night news. What else are 
people doing with /ram? 

T.S. Qoodfellow 
Raleigh, H.C. 


Mousetrapped 

There seems to be a lack of good information on the 
lie I hope your publication can supply that need as 
well as others. For instance, 1 feel suckered now for 
buying MousePaint, as I have been unable to find any 
other programs that use the lie mouse. Help. 

Tom Milford 
SL Louis, Mo. 


More mouse software should be upcoming soon. 
Apple has provided software developers with a 
Macintosh-like interface for the Apple II series that 
uses the 80-column text screen, the mouse, and the 
infamous "Mousetext" characters that occasionally 
appear on your screen where inverse capitals should 
be. Software using this interface wiil likely begin to 
appear by summer. 

I'm not completely sold on the mouse— we have a 
lot of trouble around here with the ball sliding, rather 
than rolling, across the desktop; this will drive you 
nuts with great speed. I like the features of Apple's 
human-computer mouseface, however. 

stalking the 1/0 Error 

I recently bought Terrapin Logo for the Apple and 
the disk wouldn't boot Just for the heck of it I went 
under the hood and reversed my drives. To my sur- 
prise, the disk booted ok on my former drive 2 (then 
the door hinge broke). 

At the same time, along the same lines, 1 got an 
unprotected demo disk that wouldn't load. Using Disk 
Recovery 1 checked it out and got a report that both 
sides were full of bad sectors, but strangely, the pro- 
gram couldn't seem to make up Its mind about which 
sectors were bad— they changed every time 1 ran the 
program. After my second drive was fixed, the front 
side breezed through the test with no errors reported. 

I also tested a couple of unprotected commercial 
disks that were perfectly functional. However, one con- 
tained many mis-assigned sectors and the other had 
an invalid track/sector list In both cases 1 suspect that 
the producers resorted to subterfuge to conceal a very 
substantial part of their programming and the combi- 
nation could cause the unwary to delete a large chunk 
of an otherwise valid program. 

Qardyloo, 

Ralph Moredock 
Campbell, CA 

/ have several floppy drives; the oldest has been my 
most-used drive for almost four years. Hone of them 
have ever been adjusted, aligned, or (blush) even 
cleaned. I did take one apart once to see what was 
inside, but I didn't tweek anything. 

Based on this experience, I suspect many disk drive 
problems start as software problems and become 
hardware problems only after the drive gets "adjusted " 
in an attempt to fix things. Those of you who have had 
real hardware problems will probably vehemently 
disagree with me. 

The Humber One cause of disk problems is bad 
centering. Disks must be perfectly centered in the 
drive or they won't work. There is a mechanism inside 
the drive that is supposed to center the disk, but it 
doesn't work reliably 

Hub rings on your disks help solve the centering 
problem. Most disks sold nowadays come with these; 
I recommend you refuse to buy any that don't have 
them. The hub ring stiffens the magnetic material, 
consequently the centering device does its job better. 
The original purpose of hub rings was to keep the 
center of the disk from wearing out, but this hasn't 
been a problem on 5-1/4 inch disks. 

The best tip for centering disks, however, is to wait 
until the drive is spinning before closing the drive 
door. Yes, I know all the books say not to do that. Just 
never open the door while the drive is running— or 
more exactly writing on the disk. That can destroy 
disks. But closing the door with the drive on not only 
doesn't hurt anything, it actually helps. 

A disk that is accidentally initialized while off-center 
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is particularly useless. As soon as you remove it from 
the drive you've lost any data you've saved on It. You'll 
never get it back in the drive in just exactly the same 
off'Center orientation you started with. 'Thu.s, it is very 
important to delay door-closing when initializing 
disks. 

iVhenever you have a commercial disk that won't 
boot but Just sits in the drive and spins, open and 
close the drive door. This will center the disk and 
allow it to boot about 90 per cent of the time. And 
while we're talking about doors, let's mention that it 
may not help, but it certainly doesn 't hurt to open the 
doors on your drives before you turn off your compu- 
ter. That little flicker of the in-use light could mean the 
drive head is flickering too. 

If your disk is centered properly and still doesn't 
work, the next most common problem is electrical 
interference from your display screen. Monitors and 
television sets work by guiding an electron beam 
across the screen with electromagnetic radiation. If 
your disk drive is close enough to the screen, this 
radiation will overwhelm the tiny signals the disk 
head is picking up from the magnetic fields recorded 
on the disk. 

To solve the problem, simply move the disk drive 
farther away from the display screen. Magnetic inter- 
ference occurs quite often with the lie because the 
drive is naturally close to the screen. And it occurs 
almost every time you try to use a lie while it's sitting 
on top of a television set. 

If the disk still won't boot, try changing to a differ- 
ent model of Apple. I was about to throw out two 
commercial, copy-protected disks that I thought had 
shot craps: however, I finally figured out that both 
boot Just fine on my II-Plus. It's only on lies and lies 
that they won't work. This is one of the many Joys of 
copy protection. 

Finally if your disk still won't boot, get out your 
DOS 3.3 System Master and BRUM BOOT13. 1 really 
have purchased a commercial program within the 
last year that used DOS3.2. These disks will not boot 
on today's Apples unless you boot via BOOT13. 

If that doesn't work either, you've covered about 98 
percent of the probable problems. If we split up the 2 
per cent that's left, there's a 19 per cent chance the 
disk is bad, a .09 per cent chance of some other 
problem (try cleaning the edge contacts on your disk 
drive card), and a .01 per cent chance your disk drive 
is bad. 

The only clear sign that a drive needs to be adjusted 
is that disks written with one drive can't be read by 
another and vice-versa. One of those suckers needs 
fixing. All you have to do then is figure out which one. 

As to the unusual things Disk Recovery found on 
unprotected commercial disks, I suspect an attempt 
to enhance performance rather than subterfuge is the 
root cause. For example, QPLE uses a very strange file 
structure. You can't successfully copy it by BLOADIMO 
it, finding its loading address and length, and BSAV- 
IMG it with those parameters. The reason for this isn't 
subterfuge, however, but to get it to load quickly 

AppleWorks vs Oki 

I have an Apple He, Qrappler+, and Okidata 92. Any 
idea how I can get AppleWorks to work with my prin- 
ter? As usual, my Apple dealer doesn't have the 
foggiest 

Arlene Samowich 
nashville,Tenn 

There is an answer to your problem. I Just don't 
know what it is. But here's a note I found in the 


Princeton (III) Apple Users Group newsletter, "Clancy- 
Paul (a dealer in Princeton) has found' the Apple- 
Works configuration disk that Bart Thomas donated 
to them and spoke about at the last meeting. Anyone 
who has other than an Apple Parallel Interface Card, 
or who's using an Okidata 92 printer, will probably 
need this fix to print properly" 

From yet another note in the same newsletter, I 
know that Bart Thomas is an alternate system opera- 
tor for the Micronet Apple User Group on Compu- 
Serve. Thus, I suspect Bart could put the fix you (and 
many others) need on MAUG (if it's not already there) 
and you could download it. If the fix is available from 
other sources Tm sure one of our readers will tell us 
about it. 

Dump 80 

Explain how to get an 80-column screen dump to 
printer and I'll sign up for 100 months. 

Steve Madigan 
Culver City, Calif. 

To do a screen dump, you have to peek directly at 
screen memory to get each character. Screen memory 
has a Byzantine organization, so begin by setting up 
an array that holds the starting address of each of the 
24 lines on the screen, like this: 

100 DIfl LfiDR(23] 

110 FOR 1=0 TO 23 : RERD X : LfiDR{I)=X : NEXT 
120 DRTfl 1024, 1152, 1280, 1400, 153G, 1G64, 

1782, 1820, 10G4, 1182, 1320, 1448, 

157G, 1704, 1B32, 18G0, 1104, 1232, 

13G0, 1408, IGIG, 1744, 1872, 2000 

Our program will use one loop to advance from line 
to line. A second loop inside the first will peek at each 
of the 80 characters on a line. The trick is that there 
aren't really 80 different addresses for each line. 
There are only 40 different addresses— but half of 
them (odd columns if you consider the first column 
number 0) are in main memory and half of them are 
in auxiliary memory. When the 80-column mode is 
active, you can switch back and forth between the 
two memory banks by hitting softswitches at 49237 
(even columns) and 49236 (odd columns). 

Thus, the rest of our program looks like this (don't 
forget to include the lines 100 to 120 above!): 

200 IF PEEK(70) = 180 then 250 : REN 3.3 ProDOS’’ 

210 POKE 43G02,0 : REN br^te fj^ce <c"> for DOS 3.3 

250 CRINT CHRS(4] ; "PRnl" : REM pointier on 

2G0 PRINT CHRS(8);"80N' ; REM don't mess jp screen 

300 FOR LINE = 0 TO 23 
305 : L5="" 

310 : FOR CHR=0 TO 38 

320 : : fiDR=LROR(LlNE)^CHR 

330 : : POKE 48237,0 : REM peek even ccljmns 

340 : : L5=L$ + C'-R5(PEEK(RDR) ) 

350 : : POKE ^8230,0 : REM pee'< coo ccijmns 
3S0 : : LS=LSmC-iRi{PEEK(R0R) ; 

370 : NEXT 
350 : PRINT 
380 NEXT 

400 REM Rehook 80-col sceen uitho-it erasing it. 

410 REM See tip on page G of January Open-Rpple. 

420 IF FEEK(878]=180 THEN 450 ; REM 3.3 or ProDOSP 
430 POKE 54,7 : POKE 55,185 : CRLL 1002 : REM DOS 3.3 
440 GOTO 500 

450 PRINT CHRJ(4) ;"PRHR$C307" : REM ProDQS 
500 EN3 

To get this program to work I had to resort to a 
couple of tricks you may not have seen before. In line 
200 we determine if our program is running under 
DOS 3.3 orProDOS. If 3.3, we need to print a return so 


Open-Apple 15 

DOS will recognize the DOS command in line 250— 
but a return may mess up our screen display Thus 
we resort to the brute force technique in line 210. 

In lines 250 and 260 we turn on the printer. Line 
260 has two functions. First, it tells your printer inter- 
face card that we don't want what we print sent to the 
screen. It would mess up the very display we are 
trying to dump if it did. Secondly it tells the card to 
expect 90 characters per line. Since we will be print- 
ing 80 characters plus a carriage return for each line, 
the card will actually see 81 characters per line. If you 
use the standard CHR${9);"80ri" in line 260, your 
dump will be double-spaced because both your pro- 
gram and your interface card will send carriage 
returns after 80 characters. 

Lines 300 through 390 scan the display memory 
and place the characters found in the string variable 
L$. After gathering a line, L$ is printed in line 380. The 
routine would be a lot faster if we could print the 
characters as we gather them in lines 340 and 360 
rather than saving them in a string for printing later. 
However, for reasons I don't understand, the system I 
tested this program on (a Ilc/lmagewriter combina- 
tion) consistently garbled things when I tried to FRIHT 
while the even columns were turned on. Can any of 
you wizards out there explain that? 

Finally lines 400 to 450 turn the printer off and 
return to the 80-column screen without erasing it. For 
the details on how this works look on page 6 of last 
month's newsletter. 

That will be $200, please. 

Problem too complex 

Here's a little program you may find interesting (1 
find it perplexing). 

]LI5T 

10 ONERR GOTO 100 

20 PRINT "HELLO FROM LINE 20" 

30 R="R" 

40 END 

100 1=1+1 : PRINT I 
110 CRLL -3288 : GOTO 20 

]RUN 

HELLO FROM LINE 20 
1 

HELLO from line 20 
2 

HELLO FROM LINE 20 (program hangs) 


PFORMULR TOO COMPLEX ERROR 
1 

The ca/t -3288 that you recommended in the January 
issue (page 2) doesn't work if the error is type mis- 
match or string too long. The computer hangs and 
you have to hit Reset. Then, when you try to list the 
program, you get ? formula too complex A second 
attempt to list the program usually works. What's 
going on here? I'm extremely frustrated at trying to 
bullet proof my programs. 

Brent Thorwall 
Crystal Lake, 111. 

/ haven't been able to figure this one out— maybe 
somebody else can help. The stack appears to be 
getting messed up, but in looking at the Applesoft 
code I can't see why it would. I have figured out that 
the error isn't absolutely related to type mismatch — 
try replacing line 30 withA$=A, also a type mismatch 
error, and it runs Just like it's supposed to. 

Tm sure there's an explanation for this, anybody 
out there got an easy answer? 
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Trapping Reset 

I'll be happy to contribute $24 a year to keep you 
productive and off the streets. 

How can I direct a program to line x or line y after 
Reset has been hit? 

Dennis Mah 
Federal Way Wash. 

My kids thank you. 

Your question is short, to the point, and theoreti- 
cally very easy to answer. So why has it taken me two 
days to figure it all out? In the process I've made an 
incredible, new, useless discovery about the 6502 
microprocessor. Please, no more questions like this 
one! 

Part of the reason your question was so hard was 
that I was sure I could answer it with a few PEEKS and 
POKES. I wanted to do this completely from Basic. I 
didn't want to have to stick any little assembly lan- 
guage routines anywhere. 

'The reason I had trouble is that pressing Reset, 
unbeknownst to me, scrambles the contents of the 
6502 's stack register. Applesoft uses a small section 
of the stack to parse command lines. If the stack 
register accidentally points at this area after a Reset, 
Dr. Basic trips over his own feet and tumbles to the 
ground. 

In addition to scrambling the stack pointer, press- 
ing Reset disables interrupts and causes the 6502 to 
fetch the address stored at $FFEC and jump there. On 
all but the earliest Apples $FFFC points to $FA62. 'The 
routine there is called, appropriately enough, reset. 

That routine puts the 6502 in binary (rather than 
decimal) mode; turns on normal (rather than inverse) 
characters; turns off graphics and turns on full- 
window, 40-column text with the cursor at the bottom 
of the screen; connects the keyboard for input and the 
display screen for output (disconnecting DOS from 
the I/O hooks in the process); turns off annunciators 0 
and 1 and turns on annunciators 2 and 3; clears the 
keyboard strobe; turns off any active peripheral card 
ROM; and rings the Apple's bell. 

In the He and lie, special hardware circuits also turn 
on the motherboard ROM and the main bank of RAM. 
Auxiliary RAM is disabled. On earlier Apples with 64K 
of memory on the other hand. Reset does not change 
the memory configuration. 

After doing all of the above, the reset routine takes a 
look at byte 1012 ($3F4). If this byte, called the power- 
up byte, contains the proper value, the routine next 
jumps to the address stored in a place called the 
soft-entry vector, which is at 1010 ($3F2). If the power- 
up byte contains any other value, as it always does 
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immediately after you turn on your computer, reset 
will attempt to boot a disk. 

The address usually stored in the soft-entry vector 
is the DOS warmstart address— 40383 ($9DBF) for 
DOS 3.3; 48640 ($BE00) forProDOS. 

Thus, the next thing Reset normally does is warm- 
start DOS. For DOS 3.3, this means the language card 
is switched back to whatever language had been in 
use when Reset was pressed; DOS is reconnected to 
the I/O hooks; a hOMOMICO is executed; and a jump 
occurs to Basic's warmstart address, 54332 ($D43C). 
The Applesoft prompt and cursor appear on your 
screen. Your program and data are intact, but your 
program is no longer running. 

FroDOS's Basic.system, on the other hand, handles 
warmstarts a little differently It first jumps to the 
CLEAR command inside Applesoft at 54885 ($D665), 
which empties out all your variables and leaves them 
filled with zeros. This isn't real handy if you'd like to 
recover from a Reset without losing any data. The 
CLEAR routine also fixes the stack register, however 
—something DOS 3.3 neglects to do. Mext ProDOS 
reconnects itself to the I/O links, pushes the cursor 
over to the left edge of the screen, and warmstarts 
Basic at 54335 ($D43F). Again the Applesoft prompt 
and cursor appear on your screen. Your program is 
intact but no longer running; your data is gone. 

(Mote the two Basic warmstart addresses are differ- 
ent by three bytes. ProDOS skips the first warmstart 
instruction, which sends a carriage return to the 
screen. A ProDOS reset doesn't make the screen scroll. 
A DOS 3.3 reset does. This is why It's also why Pro- 
DOS has to push the cursor to the left edge of the 
screen by hand.) 

flow you know everything there is to know (and 
much more than you probably wanted to know) 
about Reset. Your original question remains, however 
—how do you keep a Basic program running and 
send control to a special error routine when Reset is 
pressed? 

In theory all you have to do is change DOS so that 
instead of warmstarting Basic, it jumps to a Basic 
error handler. Applesoft doesn't have a "Reset" error, 
thus we'll have to use another one. There's a good one 
at 58123 illegal direct. This error occurs 

when you try to do an IMPUT, GET, or a few other 
commands from the keyboard. It never occurs in a 
running program. So let's modify DOS a little; a sim- 
ple task. 

DOS 3.3 keeps the Basic warmstart address in an 
internal vector table; it's at $9D5E (40286) when DOS 
is at its normal 48K location. ProDOS, on the other 
hand, doesn't use a vector table for this. In fact, the 
bytes you have to change move around from one 
ProDOS version to another. Luckily they're easy to 
find; first look at the ProDOS warmstart vector at 
48640 ($BE00) to determine where the actual warm- 
start code lies; the bytes that must be changed are the 
11th and 12th bytes of the warmstart code (at least 
that's where they've been in all Basic.system versions 
to date). 

After we make these modifications. Reset, in con- 
junction with an OTiERR GOTO statement in your pro- 
gram, will pass control to OMERR with the code for an 
illegal direct error (149) stored where you can fish it 
out with the standard PEEK(222). 

That's the theory anyhow. But Basic still occasion- 
ally crashes under DOS 3.3 because of stack prob- 
lems and under ProDOS we lose all our data. Let's fix 
these problems, too. With ProDOS, we'll change the 
jump to the CLEAR subroutine into a jump to just the 
stack initialization subroutine, which lives at byte 
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54915 ($D683). With DOS 3.3, we'll put the jump to 
the stack initialization subroutine over the top of the 
automatic fiOMOMICO (good riddance!). 

Whew A little program that does all this stuff follows: 

10 REM Reset trap 


20 Vl=50123 : REM address of FP illegal direct error 
25 V2=54S15 : REM address of FP stack initialization 


30 IF PEEK(970)=157 THEN 50 : REM DOS 3.3 active 
35 IF PEEK(970)=ig0 THEN 60 ; REM ProDOS active 
40 PRINT "fiCTIVE DOS NOT RECOGNIZED." : END 


50 01=40206 : REM 40K DOS 3.3 0asic uarnstart vector 

52 02=40401 : REM auto NOMONICO+1 

53 IF PEEK(40409)=0 THEN 50 : REM shuffle some 

54 FOR 1=40409 TO 40400 STEP -1 : REM DOS 3.3 stuff 

55 : POKE I,PEEK(I-3) : REM around (first 

56. Nj;XT_ _:REM RUN only!) to make it uork. 
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S0 fl2=l»PEEI<(<l8G41)-PEEK(<l0E<)2)*25G : REM (IBE001-1 
62 01=02+10 : REM fish out ProDOS adrs 


70 REM 2-byte pokes adr, value 

72 POKE 01+l,Vl/256 : POKE 01,V1-(PEEK(01+1)»256) 

74 POKE 02+l,V2/256 : POKE 02,V2- (PEEK(02+1) ‘256) 

00 ONERR GOTO 200 

100 GOTO 100 : REM lockup 

200 PRINT "ERROR 0"; PEEK(222); " IN LINE 
PEEK(219) + PEEK(219)*25G 

Run the program (nothing will seem to happen — it 
locks up in line 100) and press Reset. Line 200's mes- 
sage should appear on your screen. Since the illegal 
direct error won't ever occur naturally inside a pro- 
gram, you can always be sure its appearance means 
somebody pressed the Reset key 

Delete line 80's OfiERR and RUM the program again. 
Mow Applesoft's built-in message center will print 
?illegal direct error in 100. 

If you haven't saved the program to disk yet, do it 
now. Put line 80 back in and add 210 RESUME. RUM 
and press reset. You'll find yourself in an eternal cycle 
of errors. Too many things get changed when Reset is 
pressed to simply resume execution. Instead, warm- 
start your program with a GOTO. In this case, use 210 
GOTO 100. 

RUM again and try pressing Control-C as well as 
Reset. That, Dennis, is how you direct a program to 
line X after Reset has been hit. The only way to get out 
of our sample program now is with a hard Reset 
(control-open-apple-reset or turn the computer off). 
Sure hope you saved it tike you were supposed to. 

Remember that Reset turns off graphics and 80- 
column displays, reconfigures memory and makes 
other subtle system changes. Your OMERR routine (or 
your warmstart) may have to take special steps to set 
these things aright again. 

The modifications we made here should never be 
permanently added to DOS. They cause a lot of trou- 
ble if you don't want Reset trapped. DOS 3.3's IMT 
command could jam and 3D0G does strange stuff. 

Since this seems to have turned into a definitive 
explanation of Reset, let's mention a couple more 
things. If you ignore my advice and try to change the 
soft-entry vector (instead of leaving it pointing to the 
DOS warmstart routines), CALL 64367 ($FB6F) after 
the change to correct the power-up byte. If you don't, 
the disk will boot when you press Reset. On the other 
hand, if that's what you want to happen, just poke a 
zero into the power-up byte (POKE 1012,0). 


